home *** CD-ROM | disk | FTP | other *** search
/ Magnum One / Magnum One (Mid-American Digital) (Disc Manufacturing).iso / d7 / asci2fon.arc / ASC2FON.DOC < prev    next >
Text File  |  1990-02-12  |  7KB  |  161 lines
  1. I release ASC2FON.EXE to the public domain.  I retain no responsibility for
  2. it's use or misuse.  This programs creates an output data file.  This involves
  3. writing over any file with the same name as the data file (be warned).  If you
  4. specify the name of an existing file, this program does not ask you to confirm
  5. overwriting, but rather zaps that file replacing it with the mundane dialing
  6. directory.  An example of a very DUMB move would be to run this program as
  7. follows:
  8.  
  9. ASC2FON.EXE C:\DOS\FORMAT.COM       (*****  DO NOT DO THIS  *****)
  10.  
  11. This would, in effect, write over the file 'C:\DOS\FORMAT.COM' which on my
  12. system would prevent you from ever formating another disk without using the
  13. original DOS floppy disk.
  14.  
  15. Copyright 1990, John Toop.
  16.  
  17. Requirements: 64K free memory,
  18.               80x25 text mode,
  19.               DOS version 3 ??,
  20.               (A2F.EXE requires DEVICE=ANSI.SYS in your CONFIG.SYS).
  21.  
  22. You are free to distribute this program providing the copyright message is
  23. left intact and there is no charge (beyond normal copying costs) for that
  24. distribution, and documentation is enclosed.
  25.  
  26. ASC2FON.EXE converts ascii text files (that are in collumnar format) to TELIX
  27. 3.x FON files suitable for dialing directory usage.  ASC2FON uses direct
  28. memory writes and as such has only been tested on a monochrome monitor.
  29. A2F.EXE should work on non-monochrome monitors.  Both versions support mouse
  30. usage.  See below for more information.
  31.  
  32. Usage :
  33.  
  34.     ASC2FON textfile [datafile]
  35.  
  36. Where textfile is the file of columnar BBS listings to be added to a dialing
  37. directory, and datafile is the optional dialing directory name.  If no name is
  38. supplied NEWTELIX.FON is assumed.
  39.  
  40. Quick start: Try this with an ASCII list of BBS numbers in a file "bbs.lst"
  41.  
  42.         ASC2FON bbs.lst
  43.  
  44. If garbage appears on the screen press ESC to quit.  Then either set your
  45. video to text mode 7 (monochrome) or use A2F.EXE instead.
  46.  
  47. Now make sure the lower screen reflects your highest baud, press space until
  48. a phone number appears, align the ######## with the number, and then align
  49. NNNNNNNNNNNNNNNNNNN with the name (shrinking or expanding as needed) using the
  50. cursor keys; Use 'T' to toggle the highlighted field, press A to add the
  51. current line to an entry in your dialing directory, until all the lines you
  52. would like in the dialing directory are past.  Press D for Done and startup
  53. TELIX. Alt-D to load the dialing directory and 'O' for Other menu, 'L' for
  54. load and type in the [drive:path\]NEWTELIX.FON,  ie:
  55.  
  56. C:\BBS\NEWTELIX.FON     (*****  NOTE !! This is the default file [without
  57.                                                                      path] ****)
  58.  
  59.  
  60. You should now be looking at the names you have compiled.  Read on for more
  61. information.
  62.  
  63. If you use a mouse, I have tried to implement a mouse compatible menu.  Move
  64. the mouse to the appropriate word and press the button.  Someone please tell
  65. me if this works on anything other than a monochrome text mode system.  Is
  66. your mouse a block cursor (a square like █ )?   Should I have this program
  67. show up in your favorite color?  Not having a color system, this could be
  68. somewhat tough to test.
  69.             
  70.  
  71. 4 main types of commands are available:
  72.  
  73.         1-Ctrl keys
  74.         2-Alt keys
  75.         3-normal keys
  76.         4-mouse clicks (if mouse and driver installed)
  77.  
  78. The commands act on the status line and the current line of text which appears
  79. just above the status line.  When you start the first line of the text file
  80. should appear just above the status line.  This is the current line.  The
  81. actions on this line are to either skip the line or add it to the dialing
  82. directory.  As you will soon find out, this program only goes one way through
  83. the text file.
  84.  
  85. ASC2FON.EXE uses direct memory writes and as such may not be acceptable for
  86. your use.  I have included a slower, but hopefully, more compatible version
  87. called A2F.EXE which should solve all your problems.
  88.  
  89. Please contact me with any criticisms or comments.  I can be reached on on
  90. Pete's Place (Toronto 416-471-5229), or PN Junction (Toronto 416-465-2331), or
  91. the TELIX support BBS(Toronto 416-439-8293 / 416-284-0682), or on Compuserve
  92. 75130,1562 (BBS numbers are my life!)
  93.  
  94.  
  95.  
  96.                           Alt keys
  97.                         ************
  98.  
  99. These keys are used to change the defaults that appear.  For example if you
  100. own a 300 baud modem hold down Alt-B until 300 appears to the right of the
  101. word "baud".  If you use the same password on all BBSs (do people actually do
  102. this?) then you can edit this field with Alt-W....
  103.  
  104. If you are confused by toggles, be warned that it is made up of the computer
  105. user's worst enemy (bits).  Each of these bits have meaning as per the
  106. following obtuse explanation excerpted from a text file from the TELIX support
  107. bbs.
  108.  
  109.  
  110.  toggles description see below
  111.  
  112.           toggles,        /* bit 0: local echo - 0 = off, 1 = on */
  113.                           /* bit 1: add LFs    - 0 = off, 1 = on */
  114.                           /* bit 2: BS trans   - 0 = destructive, 1 = not */
  115.                           /* bit 3: BS key     - 0 = sends BS, 1 = sends DEL */
  116.  
  117.           dprefnum,       /* dialing prefix number to use when dialing */
  118.  
  119. If you don't understand any key, you probably don't need to change that
  120. feature from the default.  ie most bbs's use NO PARITY, 8 DATA BITS, 1
  121. STOPBITS, and ANSI-BBS terminal mode.
  122.  
  123.  
  124.  
  125.  
  126.                          Ctrl cursor keys (left/right)
  127.                        *********************************
  128.  
  129. These keys move the status line relative to the current line of text.  The
  130. ctrl Left arrow moves the text to the right.  This seems illogical however the
  131. text file is constant and the status line is actually moving left and right
  132. over the line of text.  The left arrow (like the less than symbol '<' )
  133. indicates an earlier position in the array of characters and thus the current
  134. line moves left.
  135.  
  136. Really though; The only time Ctrl keys are needed is when the author of some
  137. list has made the name and number field appear past the 80th column in the
  138. string (and thus off the screen).  A list was circulated around a few years
  139. ago that was 220 columns wide.
  140.  
  141. At present the screen is only able to shift 80 characters (1 screen width)
  142. however this may change if I get any requests. I've really only been fooling
  143. around in C for 6 months (in my spare time) so my code may not be that
  144. efficient.  The code is available on request.  I used the DeSmet C compiler,
  145. which is available on most BBSs.  One nifty use for this program might be for
  146. those of you who like to make lists of BBSs and post these lists on BBSs.  You
  147. can post a TELIX dialing directory with your list.
  148.  
  149. Would you like to glue this dialing directory to the end of your usual dialing
  150. directory?  See GLUE2.EXE ...
  151.  
  152. GLUE2.EXE is used to connect two dialing directories as follows where the 2
  153. files are mainfile and stickyfile:
  154.  
  155. Usage:   GLUE2 mainfile stickyfile
  156.  
  157. Where mainfile will have stickyfile appended to itself
  158. Don't forget to backup these files first in-case you append the wrong one
  159.  
  160. You can then use TELIX to delete any unwanted entries in the mainfile.
  161.